编写REST API

编写REST API，实际上就是编写处理HTTP请求的async函数，不过，REST请求和普通的HTTP请求有几个特殊的地方：

REST规范定义了资源的通用访问格式，虽然它不是一个强制要求，但遵守该规范可以让人易于理解。

例如，商品Product就是一种资源。获取所有Product的URL如下：

而获取某个指定的Product，例如，id为123的Product，其URL如下：

新建一个Product使用POST请求，JSON数据包含在body中，URL如下：

更新一个Product使用PUT请求，例如，更新id为123的Product，其URL如下：

删除一个Product使用DELETE请求，例如，删除id为123的Product，其URL如下：

资源还可以按层次组织。例如，获取某个Product的所有评论，使用：

当我们只需要获取部分数据时，可通过参数限制返回的结果集，例如，返回第2页评论，每页10项，按时间排序：

既然我们已经使用koa作为Web框架处理HTTP请求，因此，我们仍然可以在koa中响应并处理REST请求。

我们先创建一个rest-hello的工程，结构如下：